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A LETTER FROM THE PRESIDENT 


Dear PERSONAL PEARL Owner: 


Mankind has traveled thousands of years to find an end to brutality and hunger, 
and a beginning to human fellowship and the mutual development of an 
advanced, nurturing civilization. The Industrial Age brought the power to control 
the world. Now, the Electronic Age has brought the power of computers to 
analyze and to aid understanding. Through scientific inquiry or business 
analysis, the world is opening to human understanding. The journey into 
wisdom has just begun. 


Computers have traditionally been available to scientists at universities, to 
government and large corporations. The great scientific strides of the past two 
decades have been founded on the logical processing power of computers. 
Computers are now available for personal use at home and in business. 
PEARLSOFT is dedicated to bringing the power of computer processing to 
each unique personal computer user. PEARLSOFT believes that future great 
advances in science, government, education and business will be founded in 
personal computing. 


The corporate mission of PEARLSOFT is to design and develop computer 
software that all people can use to more fully understand their world. Computers 
have a vast potential for helping people to accomplish their objectives. No two 
computer users need exactly the same thing. So, software must be able to 
change to meet the differing needs of each unique user. Whether people use 
computers in their work or in their home life, a special kind of computer software 
is needed to bring the vast potential of computers into useful operation for each 
unique user. A special system of software is needed that allows people to 
create computer software to precisely fit their needs. 


PEARLSOFT is dedicated to providing computer software that is functional, 
easy to use, and most importantly, operates according to the unique require- 
ments of each computer user. Osborne Computer Corporation is dedicated to 
providing a quality portable computer that can be used in the office or the home. 
Therefore, we were very pleased when Osborne chose to offer PERSONAL 
PEARL on the Osborne portable computer. We hope you will be as pleased with 
the Osborne PERSONAL PEARL as we are. 


Warm regards, 


} Pe 
[Aim ‘CSommt 


William R. Stow, III 
| President, C.E.O. 
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Chapter 1 
USING THIS BOOK 


INTRODUCTION 


This book will introduce you to PERSONAL PEARL, a very special software 
package that will let you manage your information in a completely new way. 
This software can be used in its pre-programmed form (INFOSYSTEM) to do 
some of the jobs you need done now. Or you can modify the software --to any 
degree you desire -- in order to completely customize it to suit your individual 
requirements. Further, you can create your own custom software programs 
from scratch. In short, PERSONAL PEARL allows you to do productive work 
immediately, but it can also be changed and expanded as your requirements 
change and as you become more proficient at using the full power of the 
software. You and PERSONAL PEARL can grow together. 


PURPOSE and SCOPE 


The purpose of this book is to show you how to use the PERSONAL PEARL 
software to manage your information. The book guides you easily into a basic 
understanding of the software. You will be guided through an easy, step-by-step 
tutorial that takes you through the basic features of PERSONAL PEARL. When 
you are finished with this easy tutorial, you will have created your first 
PERSONAL PEARL program. You will be able to design your own forms and 
reports based on the understanding you have gained by having had “hands on” 
experience with PERSONAL PEARL. The flow of this book is as follows: 


Chapter 2 Overview’ Briefly describes how PERSONAL PEARL can be 
used to manage your information in the way best 
suited to your needs. Introduces you to the basic 
concepts of PERSONAL PEARL. 


Chapter3 Getting Step-by-step instructions telling you how to install 
Started PERSONAL PEARL so that it runs on your computer. 


Chapter 4 Getting Outlines the organization of PERSONAL PEARL and 
Around in helps you actually get started using the system. Uses 
PERSONAL information from your INFOSYSTEM (set up in Chap- 
PEARL ter 3) to help you see and understand the various 

parts of PERSONAL PEARL. 
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Chapter5 Easy 
Tutorial 


Chapter6 Glossary 


Shows you how to create a simple, but useful and 
Straightforward Address Book. Gives you hands-on 
experience and step-by-step instructions using illus- 
trations of screens and user responses. 


Follows the Easy Tutorial and defines useful concepts 
and words used throughout the Easy Tutorial for quick 
reference. 


OTHER REFERENCE MATERIAL 


Two more books are contained with the PERSONAL PEARL software package. 


These are: 


Advanced Tutorial 


Reference Manual 


A book that is designed solely to show you how to use 
the advanced features of PERSONAL PEARL. It 
covers such topics as: calculations, sorting, file main- 
tenance, sharing data between forms, printing 
address labels, etc. Upon completion of the sample 
CLIENT list and appointment CALENDAR system 
developed here, you will have a model you can not 
only use as is, but which you can use to compare your 
future development efforts. A glossary is also included 
with this book. 


Designed to provide detailed information about the 
Capabilities, features and operation of PERSONAL 
PEARL. Each chapter provides detail on specific 
actions involved with using PERSONAL PEARL, re- 
quired and optional. Appendices follow the Reference 
Manual and provide special items of information that 
may be used most frequently, and where ease of 
access is important. 


Chapter 2 


Overview 


INTRODUCTION 


The purpose of PERSONAL PEARL is to let you, the user, Managenany 
information desired such as: mailing lists, appointment scheduling, client 
‘Costing, etc. This software lets you organize and use the information in the way 
best suited for you. With PERSONAL PEARL, you can design custom screen 
displays that are used for: collection, filing, updating and analysis of your 
information. 


Under your direction, PERSONAL PEARL performs four major “services” for 
you: 


design forms, Lets you design a form (similar to a paper form) that 
aac specifies what information you want collected and what 
form the information will be in. 


Lets you design the layout of a report. PERSONAL 
PEARL then extracts the data you have specified earlier 
and fills out the report according to your design. 


Lets you add, change, or delete information (data) from a 
form -- and even lets you have one form feed data_to 
another form. a 


produce reports Lets you produce any one of the reports you have 
PELL" designed -- and lets you choose how it is to appear, such 
as on a screen on paper. 


Each of the above “services” is described separately in subsequent para- 
graphs. 
DESIGN FORMS 


In managing any information, the first step is to identify what type of information 
you want collected and in what form. This is done by using the DESIGN FORMS 
part of PERSONAL PEARL. 
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There are five basic steps in designing any form: 


DESIGN REPORTS 


form layout 


identify data 
input areas 


install form 


find records 


Share data 


You design your own form on the screen, in the same 
manner as doing it on paper. You specify each item to be 
on the form (such as ADDRESS or AGE) and how long 
each entry should be (such as two spaces to enter AGE). 


Lets you specify requirements for each entry on the form 
by letting you answer the questions: 


Is input in this area always required? 
Is the entry to be letters or numbers? 
Is any calculation needed? 


Places your newly-designed form into the computer 
system so you can use it whenever you want. 


Lets you set up unique names for any entry on a form so 
that you will avoid duplication and so you can always find 
the correct entry in the system. For example, a record 
can be defined so it is unique. In this case, if you enter a 
the name of “JOHN Q. DOE”, no other JOHN Q. DOE 
can be entered on any form. If you had two clients with 
this name, you would enter one of them as “J. Q. DOE”, 
for instance. 


Lets you extract information from one form and place it 
on another form (this is done automatically by PER- 
SONAL PEARL). For example, if you are using two forms 
(such as CLIENT LIST and APPOINTMENT CALEN- 
DAR), you could just enter the client’s name on the 
calendar and let the system automatically extract his 
phone number from the list and move it to the appoint- 
ment calendar. 


The next step is to define the way you wish your reports to print out information 
you have put into a form. You may wish your report to look exactly like your 
form, or you may want it to look quite different. You may also want to have 
several different types of reports for the same form. 
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As with forms, there are five steps in designing any report: 


@ report layout You design the layout of your report on the screen. It may 
either look like the form (in which case you may copy the 
form layout), or it be created from scratch. If the report is 
laid out from scratch, you specify each item from the form 
that you want to appear on the printed report. You may 
define a report for use with the SuperCalc spreadsheet 
software program. 


e identify data Lets you name each output area in the report using the 
output areas sameg names you specified in the entry form. In addition, 
if computations are to be performed, you define them at 
this time. 
® install report Places your newly-designed report into the computer 


system so you can use it whenever you want. 


@ sort priority Allows you to specify the order in which data should be 
printed during report processing. 


@ share data As with forms, this option allows you to call in information 
from other forms when the report is printed. 


ENTER DATA 


The enter data feature of PERSONAL PEARL allows you to enter, change (edit) 
and/or delete information on the forms you create. When you select this 
function, you name the form you wish to enter data, into and it is automatically 
displayed on your screen. You may then either ADD data, EDIT data, or 
DELETE data from the form you are working on. 


PRODUCE REPORTS 


This feature lets you print out or otherwise produce your reports. Reports may 
be produced on a printed page, relayed back to the console, or stored as output 
onto a disk (for use with the SuperCalc spreadsheet software or with word- 
processing software, such as WordStar). You may also produce mailing labels 
using the produce reports feature. You may print reports within a specified high 
and/or low range. 
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SUMMARY 

In summary, PERSONAL PEARL lets you do four basic jobs: 

e Design forms 

e Design reports 

e Enter data 

@ Produce reports 

Each of the above jobs is called a “service”. Using these services is easy and 
straightforward: 


e Design forms These two services are usually done only once. They 
Design reports set up the “form” and its associated “report(s)” for the 
information that is to be entered and printed. 


@ Enter data Use these two services get work done. Allows you to 
Produce reports put information into the “form” designed above and to 
then print the “report(s)” associated with the form. 


Chapter 3 


Getting Your Osborne Computer 
and PERSONAL PEARL Started 


Before you move on to the tutorials, review the basic features listed below. 
Information on setting up your disks, HELP, commands, messages, and CP/M 
file maintenance will allow you to move ahead with useful information already in 
your possession. 


1;. SETTING UP. 
Before you can begin, you need the following hardware and software tools: 
a. Hardware Requirements 
1) Osborne Computer (tm). 


2) Printer that prints at least 80 characters per line (a printer is not 
required, but is certainly useful). 


b. Software Requirements 

1) CP/M operating system, version 2.2 or later. 

2) Copy of PERSONAL PEARL (seven disks in all). 
The disks are your “Masters” and are labeled as follows: 
a) DESIGN FORMS Disk - 1 of 7. 
b) DESIGN REPORTS Disk - 2 of 7. 
c) INSTALL Disk - 3 of 7. 
d) ENTER DATA Disk - 4 of 7. 
e) PRODUCE REPORTS Disk - 5 of 7. 
f) FILE MAINTENANCE Disk 6 of 7. 
g) SYSTEM STARTUP, SORT & HELP TEXT Disk 7 of 7. 
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GETTING STARTED. 


In order to begin using your PERSONAL PEARL, you will need to setup a 
set of working disks from your master disks as described above. To begin 
with, be sure that you have all seven of these disks. 


In order to setup working disks, the following steps are required: 


Step 1. Label ten disks as follows: 


a. DESIGN FORMS 

b. DESIGN REPORTS 

c. INSTALL (forms and reports) 
d. ENTER DATA 

®&, PRODUCE REPORTS 

f. FILE MAINTENANCE 

g. SYSTEM STARTUP 

h. SORT 

i; INFOSYSTEM 

j. PROGRAM and DATA 


This disk will contain the programs you create using PERSONAL 
PEARL and also the information that is entered into the pro- 
grams. You would need one of these any time you create a 
program using PERSONAL PEARL. This is a blank, formatted 
disk and is placed in drive B. 


Step 2. Make Copies of Master Disks. 


Copy each of the master distribution disks onto seven working disks. 
To copy a disk on your Osborne Computer, the following steps are 
required: 


NOTE 


The use of COPY and the responses you receive from your computer may 
vary from those indicated below depending upon the version of the system 
you have received on your Osborne Computer. If your system does not 
respond as indicated and you have a question, refer to your OSBORNE 
documentation on copying diskettes. 


Getting Started 


USER: Place your CP/M system disk in drive A, and 
Press the RESET button, then 
Press RETURN 


Once CP/M is up and the A> prompt appears: 
USER: Enter: COPY, and 

Press RETURN 
Your computer will respond: 


OSBORNE DISK UTILITY PROGRAM 
Revision 3.0 


C Copy diskettes 
F Format diskettes 
RETURN exit program 


Press C to Copy, F to Format or RETURN to exit — 
USER: Enter: C 
Your computer will respond: 


Select source drive for COPY (A or B) 
or press RETURN for main menu — 


USER: Place the master distribution disk (1 through 7) in drive 


A, and 


Place the working disk (1 through 7) in drive B, then 


Enter: A 


Repeat the procedure above for each of your seven master disks. 


Once this step is completed, you should place your master distribu- 
tion disks in a safe place and from this point on only use your working 


disks. 


Step 3. Format 3 blank diskettes. 


At some point, you should format the three diskettes labeled SORT, 


INFOSYSTEM, and PROGRAM AND DATA. 
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You may do this by using the COPY utility program as described 
above in Step 2, and selecting the “F’ option rather than the “C” 
option to format these diskettes. 


Step 4. Place CP/M on Working Disks. 


USER: Place a copy of the CP/M operating system on each of 
the ten disks described above. 


(This will allow you to place any one of the ten disks you will 
be using in drive A at any time, press the RESET button, and 
begin processing.) 


In order to place the CP/M operating system on a disk, the following 
procedure is required: 


USER: Place your CP/M system disk in drive A, and 
Press the RESET button, then 
Press RETURN 
Once CP/M has loaded and the A> prompt appears, 
USER: Enter: SYSGEN and 
Press RETURN 
Your computer will respond: 
SOURCE DRIVE (A OR B) 
USER: Enter: A 
Your computer will respond: 
Put SOURCE diskette in drive A then press RETURN 
USER: Press RETURN 
Your computer will respond: 
Put DESTINATION diskette in B, then press RETURN 
USER: Place the working disk (1 through 7) in drive B, then 
Press RETURN 


Repeat the procedure above for each of your ten working diskettes. 
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Step 5. Setting up the SORT Disk. 


The PERSONAL PEARL sort program is provided on the seventh 
master distribution disk. In order to set up your working sort disk, use 
the following procedure: 


USER: Place the CP/M system diskette in drive A. 
Place your working SORT (disk number 8) in drive B. 
Press ctrl/C 
Enter the command: PIP and 
Press RETURN 
Your computer will respond with an * 


USER: Replace the system disk in drive A with your SYSTEM 
STARTUP disk (disk 7), then 


Enter: B:=A:PSORT.*[V], and 
Press RETURN 
Your computer will respond: 


COPYING- 
PSORT.001 
PSORT.002 
PSORT.COM 


USER: Remove both disks, and insert your CP/M system disk in 
drive A 


Step 6. Setting up Your INFOSYSTEM Disk. 


The programs for your INFOSYSTEM are provided on the DESIGN 
REPORTS and FILE MAINTENANCE disk. In order to set up your working 
disk, do the following: 


USER: Place the CP/M system disk in drive A. 
Place your working INFOSYSTEM (disk 9) in drive 5. 
Press ctrl/C 


Enter the commana: PIP, and 
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Press RETURN 
Your computer will respond with an * er 


USER: Replace the system disk in drive A with the DESIGN 
REPORTS disk (disk 2), then 


USER: Enter the command: B:=A:*.DIR[V], and 
Press RETURN 


Your computer will respond: 


COPYING- 
PEOPLE DIR 


USER: Enter the command: B:=A:*.ROO[V], and 
Press RETURN 
Your computer will respond: 


COPYING- 

FARLEY.ROO - 
INVOICE.ROO 

PHONE.ROO 

SCHED.ROO 


USER: Remove the DESIGN REPORTS diskette in drive A, and 


Insert the ENTER DATA diskette (disk 4) in the same 
drive, then 


Enter the command: B:=A:*.DIR[V], and 
Press RETURN 
Your computer will respond: 


COPYING- 
CALENDR.DIR 


USER: Enter the command: B:=A:*.SOO[V], and me 
Press RETURN 
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Your computer will respond: 


COPYING- 
CALENDR.SOO 
PEOPLE.SOO 


USER: Remove the ENTER DATA disk from drive A, and 
Insert the SYSTEM STARTUP (disk 7) in its place, then 
Enter the command: B:=A:PEARL.DIR[V], and 
Press RETURN 

Your computer will respond with an *. 

USER: Press RETURN 


to exit from the PIP program back to CP/M. You may leave the disks 
in both drives as they are needed to continue with System Startup. 


SYSTEM STARTUP. 


In order to personalize your working system, the following steps are 
required: 


USER: Place the SYSTEM STARTUP disk in drive A, and 
Enter the command: PEARLUP and 
Press RETURN 


You will be asked to enter your name. Once you have done this, the 
PEARLUP program will ask you to insert the DESIGN FORMS, DESIGN 
REPORTS, ENTER DATA, PRODUCE REPORTS, and FILE 
MAINTENANCE diskettes in drive A so that each PEARL system diskette 
may be PERSONALIZED for you. 


Once this step is completed, you are ready to run your system. 
RUNNING PERSONAL PEARL. 


To begin running one of the programs services (contained on disks 1, 2, 4, 
5, and 6 above), place the PROGRAM disk in drive A and a blank, 
formatted PROGRAM AND DATA disk (or your INFOSYSTEM Disk) in 
drive B of your Osborne and press RETURN. Then enter one of four 
program name choices: 
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For example: PEARLDF (design forms - disk 1) 
PEARLDR (design reports - disk 2) 
PEARLED (enter data - disk 4) 
PEARLPR (produce reports - disk 5) 
PEARLFM (file maintenance - disk 6) 


Now press RETURN. The appropriate service menu will be displayed. 


The INSTALL disk 2 is used with DESIGN FORMS and DESIGN REPORTS 
disks. You will be prompted to place the INSTALL disk in drive A when it is 
needed. 


Likewise, inserting the SORT disk 8 will be requested when it is needed to 
produce a report that requires a sort. 


Neither the SORT nor the INSTALL programs will run without being called 
for by one of the other programs. 


For additional discussion on entering data into the system, please see 
Chapter 4. 


YOUR INFOSYSTEM DISK. 


You have been provided two programs (PEOPLE and CALENDR) and four 
reports (FARLEY, PHONE, SCHED, and INVOICE) on your INFOSYSTEM 
diskette. The PEOPLE program allows you to file information about 
business contacts or people you know. The CALENDR program allows you 
keep a schedule of appointments and, if you wish, to record time spent on 
each appointement. The FARLEY, PHONE, SCHED, and INVOICE reports 
provide listings in various formats of the data saved into these two files. 
(Incidentally, the FARLEY report is named after an individual in a novel who 
helped his employer remember important tidbits of personal information 
about business contacts.) 


If these programs and reports do not meet your exact needs, you may 
customize them using the DESIGN FORMS and DESIGN REPORTS 
facilities of PERSONAL PEARL. We suggest, however, that you first 
INSTALL the forms and reports as provided on the distribution disk. Refer 
to Chapter 5, Section 5, for an example of how to INSTALL an existing 
form. 


HARD DISK. 


To change the drive specifications so that PERSONAL PEARL will run ona 
hard disk connected to your Osborne computer, the following steps are 
required: 
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Place all of the PROGRAM files on a single drive. This includes all of 
the files on disks 1 through 9 above. 


Edit the DISKS= specification in the INSTALL.DAT file (see Appendix 
C) to use the hard disk drives. 


The DISKS=dddddd specification in the INSTALL.DAT file indicates 
the disk drives where program files, data files, help text, etc., will be 
placed. Each ‘‘d” in the list indicates one category of file. Your 
distribution diskettes come configured to use drives A and B. You will 
probably want to change the drive assignments based on the number 
of drives, and drive names on your hard disk configuration. 


Note that the sixth disk in this list is the SYSTEM disk on which the 
PEARL PROGRAMS reside and must be the same as the logged-in 
drive during system execution. 


Run the PEARLUP programs as described above. This will implement 
the changes made to the INSTALL.DAT file. When the INSTALL.DAT 
changes are used by running INSTALL.COM, the following files must 
be on the currently logged drive: INSTALL.DAT, PEARL.AOO, and 
PEARLxx.COM files. (See Appendix D). 


You are now ready to run PERSONAL PEARL. When you begin 
execution, be sure that you are always logged in to the drive 
containing the PROGRAM files. 


Chapter 4 


Getting Around In PERSONAL PEARL 


The goal of this section is to acquaint you with the organizational layout of the 
various menus and screen displays of PERSONAL PEARL. Chapter 5 will 
orovide further step-by-step examples of how to use these different parts of 
PERSONAL PEARL. 


-, 


STARTING UP PERSONAL PEARL. 


There are actually four ways to get into PERSONAL PEARL. You can 
execute any one of four PERSONAL PEARL main program names (see 
Chapter 3, section 4). However, for right now, we will deal with the DESIGN 
FORMS program. The tutorial will show you your other choices for starting 
PERSONAL PEARL. 


From now on, until you choose to exit PERSONAL PEARL, you will be 
“inside” the PERSONAL PEARL system. If a change of disks is required, 
PERSONAL PEARL will inform you of what to do. If you haven't already 
done so, now is the time to: 


a. Turn on your Osborne computer, 


b. Insert the PERSONAL PEARL Design Forms disk in drive A: and your 
INFOSYSTEM disk in drive B;, 


c. Press your bootup or reset button. 
d. Type PEARLDF right after the A> and press RETURN. 


You should now be looking at a screen that reads “DESIGN FORMS’ in big 
composite letters. If not, go back and try the above steps one more time. If 
you can't get to this point and you know that you've put the correct disks in 
the correct drives on the machine, contact your dealer for help in 
identifying the problem. 


From now on, we are relying on you to take your time and read the screens. 
Many people who are inexperienced with computers may need practice 
reading from the display screen. Just take your time. Familiarity with the 


Ph Ae 
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screens, etc., is what we are after here. The relevant parts of the screens 
will be pointed out in this section. 


Perhaps you should know that we can think of no way that you can do any 
harm to this software by “playing” around. With your master copies 
securely filed away (backed up - see Chapter 3), you are safe. Now is the 
time to move around the system without worrying about what might 
happen. Soon, you will know what is happening and understand how 
PERSONAL PEARL operates. 


So, back to the screen. The critical line on this first screen is at the bottom. 
It Says: 


Press RETURN to continue, ? for HELP, or ESC to EXIT 
This line tells you the following: 


a. The ESC key is the most often used way to “back out” of any given 
part of PERSONAL PEARL. 


b. At almost every point, you can get extra HELP by entering the “?” or 
“Q" which will provide you with HELP information or a HELP code 
number. 


NOTE 


If the HELPTEXT file (PRLHELP.TXT) is not available, a HELP code number will be 
displayed. Refer to Appendix G, in your Reference Manual for the explanation associated 
with each HELP code. 


c. To get farther “into” PERSONAL PEARL, use one of the offered 
options or supply information as requested. 


At this point enter a ? and watch the results. You will see the first help 
menu. At the lower right of the screen you will see “Press RETURN ?”. 
When you do this, you will proceed as if you had entered the first RETURN 
requested above. 


FORM DIRECTORY - SELECTION SCREEN. 
You should now be looking at a screen that says: 
FORM DESCRIPTION 


on the top line. Below this is a list of the FORM names on the INFO- 
SYSTEM disk in drive B:. If no names appear, check your disk. To do this, 
press ESC until you see the A> prompt of CP/M and then enter DIR B:. 
The files listed should agree with the listing for the INFOSYSTEM disk. 


~~ 
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lf you see the list, it will include the FORM name of “PEOPLE”. The 
description says “FARLEY FILE”. The PEOPLE form is the one we will use 
in this chapter (without altering it) to gain access to the insides of 
PERSONAL PEARL. 


NOTE 


Since we don’t want to change this form or its accompanying report, we will use the ctrl/O 
command to exit the design screens we visit. We'll explain further as we proceed with the 
example. 


Right below the line you will see the prompt: 


GIVE PEARL YOUR NEW OR PREDEFINED FORM NAME: 


and below that line, 
Press RETURN to continue, ? for HELP, or ESC to EXIT 


As you can see, things are starting to appear familiar. Now, enter either a 
RETURN or ?. Leave the ESC alone for awhile since we arent ready to 
leave just yet. 


The ? got you a HELP explanation and the RETURN caused ENTER 
NAME to appear on the bottom line of the screen. At this point, it’s time to 
explain a couple of things that will be of general usefulness. 


A FORM is the basis for all the work you do in PERSONAL PEARL. Once 
you name or select a FORM, you have identified a set of information that 
you want to work with. PERSONAL PEARL associates a single FORM with 
a PROGRAM UNIT. Later, when you are tutored on designing reports, you 
will see that a REPORT is always associated with one or more FORMs 
(thus, a program unit is created through a combination of form(s) and 
reports.) In order to design or use a report, you must have previously 
specified a FORM name and completed some other steps. 


Now, enter PEOPLE and press RETURN. Notice that PERSONAL PEARL 
manages the cursor placement when you are responding to menu 
prompts. You don't have to worry about your position on the screen. 


3. DESIGN FORMS MENU 


In order to view the data input form for PEOPLE, our next step is to select 
Step 1 on the DESIGN FORMS MENU. You will note there are five steps or 
operations for designing a form. 
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Notice that the line at about the bottom third of the screen now says: 


This spot on the screen will almost always let you know where you are in 
the PERSONAL PEARL organization. Right below it, we can see the 
selected FORM NAME of PEOPLE and the following request: 


ENTER A STEP NUMBER: — 
and then: 
Press RETURN to continue, ? for HELP, or ESC to EXIT 


Press RETURN. PERSONAL PEARL will display “SELECTION OUT OF 
RANGE” on the bottom line of the screen. This message merely points out 
that you have a list of alternatives and the one you used is not valid. 


Now enter a 1 instead, for the first step, FORM LAYOUT. At this point, you 
will see the form for PEOPLE provided for you. 


FORM LAYOUT SCREEN 


PERSONAL INFORMATION FORM == page 1 
PEOPLE 


Name: 
Address: 


Zip: —. Home Phone: 

Nickname: ____ «Birthdate: 
Family: 
Likes: 

Dislikes: 


Notes: 


FORM LAYOUT - CONTROL KEY COMMANDS 
F - Word forward V- Insert char N- Insert line 


A - Word back G - Delete char Z-=- Scroll up 

C - Page forward T - Delete word W- Scroll down 
R - Page back Y - Delete Line 0 - Ignore & exit 
Q - HELP U- Line to top ESC - Save & exit 


PAGES 1 LINE: 1 COL: 1 AREA NAME: 
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As you read the screen, you will see that it is divided by a line containing 
the name of your current location in PERSONAL PEARL (Form Layout). 
Below this line are the commands you will use later on. For now, notice 


only the bottom two commands in the right-hand column. The bottom one 
is the familiar ESC, which at this point saves and exits (stores the work you 
have done). The ctrl/O command is above the ESC. Ctrl/O moves back 
up the PERSONAL PEARL system to the previous menu. Furthermore, it 
does not save any new work that has been done since arriving at this 
screen. This is an important difference worth noting right now. For these 
exercises, you should always use ctrl/O. This will make sure you dont 
alter the screen accidentally. If a screen did get altered, you could restore it 
(recopy it from the master copy). 


Now, after you have studied the screen as much as you want to, use the 
ctrl/O to move back up one level of menu. Press the control key down and 
then press O. 


We are back at the DESIGN FORMS MENU. Now enter 2 for DATA INPUT 
AREAS. Remember, we are still dealing with the “PEOPLE” form. This 
screen display of the form is like the one for FORM LAYOUT. However, 
note that certain areas on the form are shown in high intensity print and the 
ctri/B command “DEFINE DATA INPUT AREAS” is new. You'll learn how 
to use this command in the tutorial. Notice that the bottom right-hand 
commands in the list are the same as last time. The ESC and ctrl/O 
provide the ways “up and out” of this DATA INPUT AREAS screen. 


INSTALLING FORMS AND CHANGING DISKS 


At this point, you will learn two things: how to INSTALL your INFOSYSTEM 
and how to change disks. 


Press the ctri/O to return to the DESIGN FORMS MENU. Skip options 3 
and 4 on this menu and go directly to step 5. 


Now enter a5 and press RETURN. The following message will appear on 
your screen: | 


Place INSTALL program disk on drive A. 
Then press RETURN, OR, 
press ESCAPE, to terminate request. 


At this time, remove the DESIGN FORMS disk from drive A, and insert the 
INSTALL disk (disk 3). Then press RETURN. 


The message, INSTALLING FORM should appear in the message area 
at the bottom of your screen. Once your computer has finished processing 
the PEOPLE form, the following message will appear on your screen: 
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Place DESIGN FORMS program disk on drive A. 
Then press RETURN, OR, 
press ESCAPE, to terminate request. 


At this time remove the INSTALL disk from drive A, and insert the DESIGN 
FORMS disk back in the drive. Then press RETURN. 


SERVICE DIRECTORY SCREEN 


When you leave one of the four programs of PERSONAL PEARL, a 
SERVICE DIRECTORY is displayed. You can either move on to a selected 
service or return to CP/M. Here you see the four main options of 
PERSONAL PEARL. Both PEARLDF and PEARLDR would lead to a four- 
option directory. Through PEARLED, ENTER DATA and PEARLPR, 
PRODUCE REPORTS, the operational (final useable) parts of PERSONAL 
PEARL, you will only see the ENTER DATA and PRODUCE REPORTS 
options, listed here as 3: and 4:. 


At this point, you could go directly to the ENTER DATA program and begin 
to add data to your DATA file, or you could continue to install the other 
FORM and the REPORTS (using the DESIGN REPORTS option) provided 
on your INFOSYSTEM disk. The following is a discussion of what will occur 
when you choose option 3 on the SERVICE MENU to ENTER DATA. 


ENTERING DATA 


Select 3: ENTER DATA. PERSONAL PEARL is a big enough system to 
require more than a disk’s worth of programs. Selecting the ENTER DATA 
option at this time is just to gain moree experience with disk changing and 
to review the ENTER DATA menu. 


You should see the following: 


Place ENTER DATA program disk on drive A. 
Then press RETURN, OR 
press ESCAPE, to terminate request. 


If you change to the correct disk (disk number 4) and press RETURN, you 
will be able to continue. If you put the wrong disk in drive A, one that doesn't 
contain PEARLED, the same prompt will be there. If you enter an ESC, you 
will exit to CP/M. 


Go through with the disk change to assure yourself that you know how it 
works. This part of PERSONAL PEARL will take you straight to a screen 
containing the image of our example. The screen is blank and waiting for 
you to enter data. Please don't enter any data at this time. Just use the ESC 
key to leave. Since you are now in the area of operation for entering your 
“real” information, you must confirm that you want to leave. 
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Notice that a message appears at the bottom right of the screen saying 
“EXIT?”. If you enter a “Y” or “y”, the exit will occur. Entering anything else 
will cancel the exit request. 


After that, return to the DESIGN FORM disk. To do this, you will have to get 
to the SERVICE DIRECTORY by completing the exit from the ENTER 
DATA screen and pressing ESC once more. Select 1: DESIGN FORMS 
and press RETURN. The prompt for a disk change will appear and you 
once again change disks. 


REPORT SELECTION SCREEN 


At this point, you might try returning to the SERVICE DIRECTORY from the 
DESIGN FORMS MENU (press ESC) and select 2: DESIGN REPORTS. A 
screen very similar to the one for selecting a form will appear. This time all 
the REPORTs for the current FORM selection will be displayed. You should 
see a listing for “LABELS”. Enter LABELS and press return. 


DESIGN REPORTS SCREEN 


Now you have the menu with the options for designing a report in front of 
you. It strongly resembles the equivalent screen for designing forms. Select 
1: REPORT LAYOUT and see the mailing label report which has been 
designed for the PEOPLE form. 


If you wish, you can now return to the DESIGN REPORTS MENU (use 
ctrl/O) and select other options to examine. If you want to leave 
PERSONAL PEARL, just use the ESC key until the CP/M A> prompt 
appears. 


Now you've seen how to move around inside PERSONAL PEARL. When 
youre sufficiently comfortable with the process, move on to the Easy 
Tutorial, where you'll begin to see and use the capabilities of PERSONAL 
PEARL. 


Chapter 5 
Easy Tutorial - Address Book 


INTRODUCTION 


To introduce you to the features of PERSONAL PEARL, let’s create a simple 
program that you can immediately use -- an address book. 


To create this program, we will do four things: DESIGN FORMS, DESIGN 
REPORTS, ENTER DATA and PRODUCE REPORTS. We will use only the 
simplest functions of PERSONAL PEARL in order to familiarize you with the 
basic concepts. The Advanced Tutorial User’s Guide will go into the details 
about the more powerful aspects of the system. 


The address book, in its physical form, looks like this: 


Company Name: 

Address: 

5) | iE. |S 5 aOR dy 6 
Phone No.: 


Our application program is going to look just like this book. The only difference 
is that we will be able to call the addresses up on a video display screen and/or 
print them out on a printer from a computer “file” rather than find them by leafing 
through an address book. Each separate address on the file we are creating is 
called a “record”. 


Remember, you are using several disks. Thus, it may be necessary for you to 
“swap (exchange) in and out of drive A whenever you need to “access” a 
particular program. For example, if you are done designing forms and wish to 
enter data, you will need to swap disks once the ENTER DATA option is 
selected. Don't worry. You will hear a “beep” when a disk swap is required, and 
a message will appear telling you which disk to put in drive A. 


ee 
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COMMANDS 


When you select one of the options of PERSONAL PEARL, a COMMAND 
CONTROL KEYS menu will be displayed at the bottom of your video display 
screen. These control commands allow you to add, edit, insert, or delete text. 
Other important data entry/editing capabilities, such as saving a file or stopping 
a computer operation are provided as well. (See Appendix F of the Reference 
Manual for more detail on Control Key Commands.) 


Each command is invoked by pressing the appropriate keyboard character 
while holding down ithe CONTROL (ctrl) key. The control function is illustrated in 
this manual as follows: 


ctri/character, e.g., ctrl/N 


The keyboard character represents the desired function and is pressed while 
the ctrl key is also pressed. For example, if you wanted to delete a character, 
you would depress ctrl and the character G together, e.g., ctrl/G (or lowercase 
g). Or, if you wanted to insert a line, you could depress ctrl/N and a blank line 
would appear so you could add a line. A short description of each command is 
also provided for those not already familiar with them. 


There are two important points to remember when using commands: 
@ Press CTRL and the letter at the same time. 


@ You can use either an upper or lowercase letter. For example: ctrl/n and 
ctri/N do the same thing. 


Additionally, you may enter the CP/M command ctrl/P in order to get a printout 
of your screens during creation of your program. This capability is particularly 
helpful for proofing purposes (see Chapter 4 of Reference Manual - Design 
Aids). 


The up, down, left and right arrows on your terminal keyboard may be used for 
cursor positioning as well as those keys provided in the COMMAND CONTROL 
KEY menus. A sample of the COMMAND CONTROL KEY menu displayed 
during the DESIGN FORM LAYOUT is shown below: 


FORM LAYOUT - CONTROL KEY COMMANDS 
F - Word forward V - Insert char N - Insert Line 
A - Word back G - Delete char Z —- Scroll up 
C - Page forward T - Delete word W - Scroll down 
R - Page back Y - Delete Line O - Ignore & exit 
Q@ - HELP U - Line to top ESC - Save & exit 
PAGE: LINE: COL: AREA NAME: 
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HELP EXPLANATIONS 


PERSONAL PEARL provides extensive on-screen “help” explanations. The 
HELP capability gives you immediate access to information about the functions 
of PERSONAL PEARL and how to implement them to build your own programs 
and reports. 


HELP may be obtained during a session with PERSONAL PEARL by simply 
depressing ? or Q. An explanation is then provided pertaining directly to the 
particular function you are working on. 


You may leave “HELP” at any time by depressing the ESCAPE key on your 
terminal. 


The printed HELP explanations file is also provided in Appendix G of the 
Reference Manual. In some cases, it may be desirable to not have the HELP 
explanations “on-line” because these explanations do take up a significant 
a of work space on your disk. Therefore, HELP is also provided in printed 
orm. 


MESSAGES 


Messages are displayed in the lower right-hand corner of your video display 
screen. Messages are of brighter intensity than the regular text so they are easy 
to see. A message may ask you a question or it may simply provide information, 
such as your current status. For instance, one message requiring a response 
from you is: NOT LOCATED-ADD (Y/N)?. In this case, PERSONAL PEARL is 
saying it could not find a name for you and wants to know if you wish to add it. 
You would respond by entering either a “Y” or “N”. On the other hand, a 
message might say PRINTER, or ADD, or EDIT. These messages are infor- 
mational and simply tell you your current status (i.e., printer operating, adding 
records, or editing records). ; 


Special messages pertaining to conditions in your system give you instructions 
for running your program. These may originate in from different areas, such as: 


@ PEARL software, 
e@ CP/M operating system, 


e Other software being run with PERSONAL PEARL (i.e., SuperCalc or 
WordStar), or 


@ During program installation process. 
These special messages are described in Appendices A and B of the 


Reference Manual and provide you with detailed information concerning 
solutions to the situations described by the special messages. 
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SECTION 1. DESIGN FORMS 


You are ready to begin once your Osborne computer and printer (if used) are 
plugged in and turned on. 


USER: Turn on your computer. 
Place your DESIGN FORMS Disk 1 in drive A. 
Place your PROGRAM AND DATA Disk in drive B. 
Depress RETURN 


NOTE 


lf the computer does not respond after you turn it on, it may be because the CP/M 
operating system is not on the PERSONAL PEARL disk you have inserted in drive A. Make 
sure CP/M is on your disk, then try again. See Appendix H for discussion. 


You should see the following ‘prompt’ on your video display screen: A>. 
Immediately following this prompt, tyoe PEARLDF and depress return. 


A>PEARLDF 
Depress RETURN 


NOTE 


The placement of the “cursor” tells you where you are. The cursor is normally in brighter 
intensity than the other text on the screen and may be located after a prompt or at the 
beginning of an input line. As you enter information, notice the bottom of your video 
display screen. At times, prompts (or messages) will appear which may require a 
response from you. (This tutorial tells you how to respond.) 
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This is the first screen displayed after signing onto DESIGN FORMS. The “AAA” 
in the above screen represents the first three characters in the serial number 
assigned to your copy of PERSONAL PEARL (i.e., RSI), and the “nnnn” is the 
actual number of your copy of PERSONAL PEARL. VERSION represents the 
version number of PERSONAL PEARL you have. 


USER: Depress RETURN 


Once you have pressed RETURN, the Form Directory is displayed as follows: 
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The Form Name may be from one to seven characters long. This will be the 
name of your form. 


USER: 


After GIVE PEARL A NEW OR PREDEFINED FORM NAME: 


Type ADDRESS, then 
Press RETURN 
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USER: Type Y to ADD to Form Directory 


. 3 The phrase “NOT LOCATED-ADD” means that the form name you have 
entered is not on your Form Directory. You may ADD it by typing “Y”. 


USER: After DESCRIBE ADDRESS, 
Type MY ADDRESS BOOK, then 
Press RETURN 


A description is provided as an aid to you later on when you select a Form 
Name from the directory. 
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USER: Press RETURN 


The ADDRESS-ADDED message tells you that the name you have entered has 
been ADDED to your Form Directory. 


—— 


e 


‘ 


ou are now taken into the D 


USER: Select 1 and 
Press RETURN 


Section 


esign Forms menu: 


1 - Design Forms 
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USER: Press RETURN 


This screen tells you that if you press RETURN you will get a blank screen and 7, 
be able to begin typing in the layout of your form. 
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Note that all the ctri/commands you need to move around the working screen 
are listed in the FORM LAYOUT - CONTROL KEY COMMANDS. The full 
definitions are listed in Appendix F of the Reference Manual, but they work 
pretty much as you might expect from their short descriptions. 


USER: Type in the above layout. 


If you want the HELP explanation for this screen, place the cursor in 
the left-most column of any line and press Q. 


Once you have completed laying out the address form: 


USER: Press ESCAPE 
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The message “SAVING FORM” tells you that the form layout you have just 
entered is now being saved on the disk you have in drive B for future use. You 


are now returned to the Design Forms Menu for the next step. If you do not want 
to SAVE your form, you would press ctrl/O. 
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( ) USER: Select 2, and 
Press RETURN 
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USER: Position cursor on first underscore after Company Name: — 


Press ctrl/B (for define data input area) 


This screen allows you to “define” your data input areas. Note the input area to 
be defined is in brighter intensity. 


Cursor is positioned after NAME THE INPUT AREA HERE: 
USER: Type NAME and 

Press RETURN 
Cursor is positioned after IS INPUT REQUIRED? (Y/N) 
USER: Type Y 
Cursor is positioned after TYPE OF INPUT? 
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NOTE 


You will notice that some areas requiring a response already have a ‘response’ in them, 
such as “‘C” for INPUT TYPE. You may simply press RETURN if the response you desire 
is already contained in the response area. 


USER: Press RETURN 


Cursor is positioned after FORMULA FOR COMPUTATION OF INPUT 
(OPTIONAL): We will not use computations in this tutorial. (The Advanced 
Tutorial Guide covers these options.) 


USER: Depress RETURN twice, or press ESCAPE 
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Define the rest of the data input areas as follows: 


ae 


Address: 


ADDR 

Y 

C 

Press RETURN twice 


City: 


CITY 

¥ 

G 

Press RETURN twice 


State: 


SLATE 

* 

CG 

Press RETURN twice 


Zip: 


ZIP 

ye 

N 

Press RETURN twice 


Phone No.:: 


PHONE 

N 

C 

Press RETURN twice 


(name) 
(required) 
(type - character) 
(no formula) 


( 
(required) 

(type - character) 
(no formula) 


(name) 

(required) 

(type - character) 
(no formula) 


(name) 
(required) 
(type - number) 
(no formula) 


(name) 

(not required) 
(type - character) 
(no formula) 


All input areas have been defined. You may now go to the next step. 


USER: 


Press ESCAPE 
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Depressing ESCAPE saves the input areas you have defined and returns you to 
the Design Forms Menu for further steps. 
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Optional Steps 3 and 4 are not covered in this tutorial as they are “advanced” 
features and not required in order to use a PERSONAL PEARL created system. 
However, these options are covered in the Advanced Tutorial Guide. We are 
now ready to INSTALL the ADDRESS form so that is may be used for entry of 
data. 


USER: Select 5, and 
Press RETURN 


NOTE 


You may be prompted to place the INSTALL disk in drive A at this time. If so, do this and 
then press RETURN. The words “INSTALLING FORM” will be displayed during this 
process as shown below: 


After installation of your form is completed, you will automatically be returned to 
the Design Forms Menu. In order to go to the next option, you should press 
ESCAPE. The Service Directory will then be displayed so that you can move 
from Design Forms to Design Reports. 


» 
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You may select another option at this time, or leave PERSONAL PEARL by 
depressing ESCAPE. You will see the A> on your display screen when you 
leave PERSONAL PEARL. 


USER: Press ESCAPE or 
Select Service 2 (Design Reports) 


This completes designing a form layout for ADDRESS. The next part of this 
tutorial deals with designing a report for ADDRESS. 
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SECTION 2. DESIGN REPORTS 


Once you have designed your INPUT form, you may now design your reports. If WW 
you have returned to CP/M, you will have the “A prompt” displayed (A>) and 
must enter the following: 


After A>, enter PEARLDR and press RETURN. 


If you have not returned to CP/M, but are still in the SERVICE DIRECTORY, 
select 2 to design reports and go to Page 46. 


Place the DESIGN REPORTS disk in drive A. 


The Design Reports screens is displayed after entering PEARLDR: 


Section 2 - Design Reports 


NOTE 


In depth discussion on the Design Reports process will be found in the Reference Manual. 
Again, the more advanced features of PERSONAL PEARL are covered in the Advanced 


Tutorial. 


USER: Depress RETURN 


After depressing RETURN, the Form Directory will be displayed. 


NOTE 


ADDRESS is the only form on your Form Directory. 


USER: Enter ADDRESS and 
Press RETURN 
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Section 2 - Design Reports 47 


This is the Report Directory for the form ADDRESS you have just selected. It will 
only show reports defined for this form. Each form has its own Report Directory. 
You may have several reports associated with a single form. 


USER: Enter ADRLIST and 
Press RETURN 


USER: Enter Y 


Since ADRLIST is NOT LOCATED, it must be ADDED to the Report Directory 
by typing “Y". Once it has been added, the NEW REPORT OPTIONS will be 
displayed. 
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For this example, we will design our report example from scratch. 
USER: Enter 3 and 
Press RETURN 
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We are asked to DESCRIBE ADRLIST and then to select the KIND OF 
REPORT. 


USER: Enter MY ADDRESS LIST and 
Press RETURN 
USER: Enter L and 
Press RETURN 


USER: Press RETURN 
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After ADRLIST has been selected, the Design Reports menu is dislayed for the 
next step. 
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Note that Form Name is ADDRESS and Report Name is ADRLIST. The first 
thing we will do is to layout the report. 


USER: Enter 1 and 
Press RETURN 
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You are now ready to type out the report on the display screen. 


USER: Press RETURN 


The above Control Key Commands are used to move around the typed-in 
report. 


NOTE 


The word HEADING in the lower left-hand corner. You are entering a LIST-type report. 
LIST-type reports have several levels available: HEADING, DETAIL, SUBTOTAL, TOTAL 
and FOOTING. To get to the different levels, you must press ctrl/C. For example: 
HEADING is the first level -- you must press ctrl/C to get to the next level called: DETAIL. 
For this tutorial example, the only level used is DETAIL. 


NOTE 


Although ctrl/C and ctrl/R are used during report layout to go to and from levels during 
list-type report definition, they are used to “page forward” in every other case. See 
Appendix F of the Reference Manual. In those cases, the word “Page” is seen rather than 
“Group” as in this area. 


USER: Press ctrl/C 


Section 2 - Design Reports 53 


Before you begin entering the report layout, make sure that the lower-left hand 
corner of your screen says DETAIL as shown below. If it still says HEADING, it 
is because you have not pressed ctrl/C. Please do this first. 


Type the following report layout. 


NOTE 


Typing “<BLANK>” forces a blank line during printing of the report. Therefore, each record 
for ADDRESS will have two blank lines at its beginning, effectively double spacing before 
the next one prints. 


USER: Press ESCAPE 
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nce report layout is completed, the report will be SAVED as shown below. 


he Design Reports menu will now be displayed for the next step. 
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The next step is to define the DATA OUTPUT AREAS. 


USER: Enter 2, and 
Press RETURN 


The Control Key Command menu is displayed for defining the data output 
areas. 
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USER: Position cursor at first underscore after Name: 


Press ctrl/B 


NOTE 


When initially defining output area names, you must position the cursor at the beginning of 
the output area. Once the output area has been defined, you may place the cursor 
anywhere in the output area to do other things. 
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y ) USER: Type NAME 
Press RETURN three times, or ESCAPE once 
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Use the same names for the remaining data output areas as were used for the 
ADDRESS form. Depress the ctrl/F and ctrl/B combinations for each area and 
name as follows: 


OR Wh 
op) 
sei 
> 
at 
Mm 


Note that none of these output areas contain a formula. 
When you are done: 


USER: Press ESCAPE 


The Design Reports menu is displayed for the next step. 
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Now that steps 1 and 2 have been completed, the report may be installed so it 
a will be ready to use for printing. 


We are now going to INSTALL our completed report. Optional Steps 3 and 4 are 
covered in the Advanced Tutorial Guide. 


USER: Enter 5 and 
Press RETURN 


You will be prompted to place the INSTALL disk in drive A. The screen display 
will show the words “INSTALLING”. 


INSTALLING REPORT 


c When installation is completed, you will be prompted to put the DESIGN 
REPORTS disk in drive A and then you will be returned to the Report Directory. 
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USER: Press ESCAPE 


Report installation is now complete. The next part of the tutorial will show you 
how to enter data into your program ADDRESS. You can press ESCAPE once 
to return to the Service Directory. You may then exit from PERSONAL PEARL 
and return to CP/M or chose a service from the Service Directory, i.e., select 
option 3, ENTER DATA. 
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SECTION 3. ENTER DATA 


You are ready to ENTER DATA into ADDRESS. If you have return to the CP/M 
A> prompt, place your ENTER DATA disk in drive A and enter the command 
PEARLED. If you are at the Service Directory after installing the report, then 
enter Option 3. 


A>PEARLED 
Depress RETURN 


The Enter Data screen is displayed. 


USER: Depress RETURN 
When RETURN is depressed, the Form Directory menu is displayed. 
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Press RETURN to continue, ? for HELP or ESC to EXIT 


USER: Enter ADDRESS and 
Press RETURN 


Press RETURN to continue, ? for HELP or ESC to EXIT 
ADDRESS-SELECTED 
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Once ADDRESS is selected, the ADDRESS form will be displayed for data 
| entry. 


Additional editing comands are as follows: 


S or H - Cursor left _ C- Page forward | 
D or L - Cursor right R - Page back 
E or K - Cursor up 

X or J - Cursor down 


You may now begin adding information (records) into the ADDRESS form. 
Notice that ADD appears on the bottom line of the screen. You cannot EDIT any 
records until information has been ADDed first. See CUSTOMIZING (the last 
Easy Tutorial) for a brief example of how to use this function. | 


| } Cursor is at Company Name:~ Type: JOHN’S COMPUTER COMPANY 
| Press RETURN 


Cursor is at Address: — Type: 123 MAIN STREET 
Press RETURN 
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Cursor is at City: — Type: CHARLOTTE 
Press RETURN 
Cursor is at State: — Type: NC 
Cursor is at Zip; — Type: 22232 
Press RETURN 
Cursor is at Phone No.: . Type: 201-322-6565 
Press RETURN 


Information for this record has been completed. 


Press ctrl/U or press RETURN. This actually ADDs the record to the ADDRESS 
form. 


Note the words RECORD ADDED indicating that the information you have just 
entered has been added as a record to the ADDRESS form. 


ADD another address. 
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Cursor is at Company Name:—~ Type: COMPUTER SCIENCE CORP. 
Press RETURN 


Cursor is at Address: — Type: 987 TRADE STREET 

Press RETURN 
Cursor is at City: — | Type: SALEM 

Press RETURN 
Cursor is at State: — Type: OR 
Cursor is at Zip: — Type: 97321 

Press RETURN 
Cursor is at Phone No.: — Type: 503-693-3333 

Press RETURN 


Information for this record has been completed. 


Press ctri/U or press RETURN 
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ADD another address. 


Cursor is at Company Name:~ —s Type: SIMON’S COMPUTER NETWORK 
Press RETURN 


Cursor is at Address: — Type: 64 NORTH 82ND AVENUE 
Press RETURN 

Cursor is at City: — Type: RALEIGH 
Press RETURN 

Cursor is at State: — Type: NC 

Cursor is at Zip: — Type: 22333 


Press RETURN 


Cursor is at Phone No.: — Type: 201-622-9732 
Press RETURN 


Information for this record has been completed. 
Press ctrl/U or press RETURN 
We have provided three examples of entering information. You may either ADD 
(or EDIT) more addresses or go to the next service step and PRODUCE 
REPORTS. 
USER: Press ESCAPE 
PERSONAL PEARL will respond with the message EXIT? (Y/N) 
USER: Press Y 
Press RETURN 


NOTE: 


If you were to answer with an “N”, then you would be allowed to continue to ADD (or 
EDIT) data. 


After entering “Y", a service menu will be displayed on the screen. If you wish to 
exit PERSONAL PEARL at this time and return to CP/M, the press ESCAPE 
twice. Otherwise, select option 2, PRODUCE REPORTS. 


e~ 
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SECTION 4. PRODUCE REPORTS 


Once you have finished entering data into ADDRESS, you may print your report. 
If you have returned to CP/M, you will have the “A prompt” displayed (A>) and 
must enter the following: 


After A>, enter PEARLPR and press RETURN. 


If you have not returned to CP/M, but are still in the Service Directory, select 2 
to PRODUCE REPORTS, see Page 69. 


The Produce Reports screen is displayed after entering PEARLPR: 


o 


USER: Depress RETURN 


After pressing RETURN, the Form Directory is displayed. 
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USER: Enter ADDRESS and 
Press RETURN 
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Now the Report Directory is displayed so that you may choose the report to be 
printed for ADDRESS. 


USER: Enter ADRLIST and 
Press RETURN 


70 Easy Tutorial User's Guide 


Once ADRLIST has been “loaded”, the Produce Reports menu is displayed so 
that you may select the desired format. 


USER: Enter 2 and 
Press RETURN 
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USER: After TITLE: | 
Press RETURN | 

After NUMBER OF REPORT LINES... 

Enter 60 and 

ress RETURN 

fter TOTAL LINES PER PAGE, | 


ress RETURN 
fter FILE NAME FOR REPORT, 


ress RETURN 

fter NUMBER OF FORMS ACROSS, 
ress RETURN 

fter SINGLE FORM WIDTH, 

ress RETURN 
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PRINT DETAIL is now complete. 
USER: Press RETURN, or ESCAPE 


USER: Select 3 and 
Press RETURN 


The video screen will display PRINTER when the report is actually printing on 
the printer. When this message disappears, you will have the following report: 


Name: JOHN'S COMPUTER COMPANY 
Address: 123 MAIN STREET 

City: CHARLOTTE State: NC Zip: 22232 
Phone No.: 201-322-6565 
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Name: COMPUTER SCIENCE CORP. 
Address: 987 TRADE STREET 

City: SALEM State: OR Zip: 97321 
Phone No.: 503-693-3333 


Name: SIMON'S COMPUTER NETWORK 
Address: 64 NORTH 82ND AVENUE 
City: RALEIGH State: NC Zip: 22333 
Phone No.: 201-622-9732 


Once the report is finished printing, the Report Directory will be displayed. 


USER: Press ESCAPE 


The last example in this chapter demonstrates how to “customize” the address 
program we have just created. 


74 Easy Tutorial User's Guide 


SECTION 5. CUSTOMIZING 


Customizing is the ability to change or tailor a program unit to suit our unique 
requirements. Often, requirements change over time. Customizing is a very 
important capability. 


Let’s say that we realize we want the name of a “contact person” included with 
our ADDRESS list. In order to do this, we must go in and redesign our form and 
our report to accommodate an extra line being added to the layout of each. This 
is how we want our form and report to look now: 


Company Name: 

Contact Person: 

Address: 

EE reece ORES aed Te 


Phone No: 


The first action we must take is to go back into the ADDRESS form we have 
created and then select Service Step 1, DESIGN FORMS. We then select Step 
1, FORM LAYOUT. The screen will appear as it was originally designed. We will 
add Contact Person to the form as follows: 


Company Name: 

Contact Person: 

Address: 

CHYS a Stee Lip 999999999 
Phone No: 


FORM LAYOUT — CONTROL KEY COMMANDS 
F - Word forward V- Insert char N - Insert Line 
A ~ Word back G - Erase char Z-Scroll ip 
C - Page forward T - Erase word W- Scroll down 
R - Page back Y - Erase Line 0 - Ignore & exit 
Q — HELP U- Line to top ESC — Save & exit 
PAGE: 1 LINE: 3 COL: 52 AREA NAME: — 


ws 
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NOTE: 


The 9’s after the zip indicate that the input area was defined as “Numeric” when the data 
input area was originally defined. 


This is done by placing the cursor at the “Address:” line and then pressing 
ctri/N twice. Two blank lines are added to the form. Then, the phrase Contact 
Person: etc., is laid out. 


The form is SAVED by pressing ESCAPE. 


The next step is to select Step 2, DATA INPUT AREA. Place the cursor after the 
first underscore following Contact Person: — and press ctrl/B. The DEFINE 
DATA INPUT area screen is displayed and we enter CONTACT as the name 
for this input area as follows: 


ate: 


The final step in redesigning the form layout is to re-INSTALL the finished form, 
Step 5, FORM INSTALLATION. We must do this in order for the form to be 
updated with the changes that have been made. 


The next step is to redesign the report layout. Select Service 2, DESIGN 
REPORTS. Then select Step 1, REPORT LAYOUT. The original report layout 
screen will be displayed on the video screen. You will add the line Contact 
Person: —. etc., just as was done for the form layout as follows: 
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Now save the report layout (press ESCape) and go to Step 2, DATA OUTPUT 
AREAS to define the the data output area for CONTACT: 
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The final step in report layout is to re-INSTALL the report that has been 
changed, Step 5, REPORT INSTALLATION. This must be done in order for the 
changes that have been made to take effect. 


Now that both the address form and report have been redesigned and intstalled, 
you may select Service 3, ENTER DATA (or Service 1, ENTER DATA if you are 
coming in from the PEARLED program). We will be “editing” the three records 
that have been added to the ADDRESS form. After selecting to ENTER DATA, 
the blank form, with the extra new line, will be displayed on the video display as 
follows: 


You will note that the ADDRESS form is laid out on the screen with the new line 
added. You will also note that we are in “ADD” mode. Since we already have 
three records on the file, we wish to go into EDIT mode. To do this, enter ctrl/B 
to toggle switch to edit. We are told we are now in EDIT mode and we are 
prompted to ENTER KEY. We will enter an “A” after Company Name: to obtain 
the first record on the file. 
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Now the first record we originally added will be displayed on the screen for 
editing. Note that the only blank area is Contact Person. The other areas have 
previously been filled in during the ADD operation discussed earlier. 
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Position the cursor to Contact Person (ctrl/!) and then add the name SARA 
JONES. Once you have entered this name, depress ctrl/U and the screen will 
be displayed again (blank) with the message “RECORD REPLACED”. In order 
to get to the next record, press ctrl/Z twice. The next record will be displayed so 
you can enter the contact person for that company. The name entered here will 


be JOHN PHILLIPS. 
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Press ctrl/U again to replace the record and then press ctrl/Z to get the next 
record for editing. The next record will have the name ANTHONY SIMON 
entered into it. 


Press ctrl/U to replace the record. All three records have now been replaced. If 

you press ctrl/Z after this last record is replaced, a message will be displayed 
telling you that you are at the END OF FILE. You may either ESCape from the 
ENTER DATA service, or you may switch to ADD mode (depress ctrl/B again) 
to add some more records to ADDRESS, or you can press ctrl/W to get the 
previous record. 


If you were to select Service 2, Produce Reports, you could produce a report 
which would show the new line of Contact Person having been added to each 
printed record. 


wo 


c~ 


Chapter 6 
Glossary 


CONCEPTS AS TOOLS 


The concepts and terms used throughout your PERSONAL PEARL software 
are assembled in a glossary following each tutorial. The first glossary gives you 
a list of terms and definitions that are used in the first tutorial. The purpose of this 
list is to establish a common ground for understanding and using these terms 
within the context of the PERSONAL PEARL package. The second glossary, 
found in the Advanced Tutorial User's Guide provides advanced concept 
information relating to the additional PEARL functions described in that tutorial. 


The concepts presented in both lists are for the most part nontechnical and 
descriptive, making it easier for you to understand and use PERSONAL PEARL. 


TERM DEFINITION 


DATA AREA This is a term used to describe a segment or unit of 
(DATA INPUT information. For example, a FORM that is used to record 
AREA, DATA names and addresses will have a DATA AREA for the 
OUTPUT AREA) name and another DATA AREA for the address. These 

DATA AREAS are empty on a FORM that has not been 
filled out. A DATA AREA on a FORM is also referred to as a 
DATA INPUT AREA, meaning that data is to be input or 
recorded on a FORM. 


A DATA OUTPUT AREA is a term to describe a segment 
or unit of information on a REPORT. 


In the FORM LAYOUT described above, the underscored 
lines next to “Name”, “Address”, and “Phone” are the 
DATA INPUT AREAS for the FORM. 


DATA AREA Each DATA AREA must have a 7-character word for a 

NAME name. This DATA AREA NAME is used as a reference 
when designing REPORTS or other FORMS on which it is 
required. This NAME is also used to create mathematical 
formulae. 


att < 
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DATA AREA 
IXPE 


DATA DISKETTE 


DATA FILE 


DEVELOPMENT 
DISKETTE 


DEFINITION 
FILES 


DIRECTORY 
FILE 


FILE 


The DATA AREA TYPE is a term used to distinquish DATA 
AREAS that will contain any CHARACTER found on your 
keyboard from those that will only contain a DATE or from 
those that will only contain a NUMBER. 


This is a PRODUCTION DISKETTE that contains only the 
program DATA FILE and the program INDEX FILE. This 
diskette is generally used when more room is needed on 
the PRODUCTION DISKETTE to accommodate the expan- 
sion of the DATA FILE. 


This is a term used for files that store the completed or 
filled out FORMS you add to the program. This file gets 
larger as you add more FORMS (data) to it. 


This term is used to describe the disk on which your 
PROGRAM FILES are found or created when you are 
developing the program. This is the PROGRAM DISK 
during development. It is generally placed on drive “B” of a 
two disk drive computer. 


This is a term used for PROGRAM FILES that hold the 
definitions and instructions for the PROGRAM 

being created. This information includes the FORM and 
REPORT LAYOUTS and all other program definitions you 
have made. These files are also referred to as PROGRAM 
SUPPORT FILES. 


This is the name of the PROGRAM FILE that stores a list of 
PROGRAM NAMES or program REPORT NAMES. It is 
often referred to by the terms PEARL DIRECTORY, FORM 
DIRECTORY, and REPORT DIRECTORY. 


This term is used to describe a storage place. A close 
analogy is the filing cabinet found in most offices. Just like 
a filing cabinet, a file can be used to store any type of 
information. A program is stored in a file. In the case of 
PERSONAL PEARL, a program created by you is stored on 
several files. Some are used to store program definitions 
and are called PROGRAM DEFINITION FILES. Others are 
called DATA FILES and are used to store data such as the 
names, addresses and phone numbers as described in the 
ADDRESS tutorial. (For more information on program files 
see Appendices D and E.) 


FORM 


FORM LAYOUT 


FORM NAME 
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This term is used to describe how data is stored on a file. 
All the forms on a file look the same and hold the same 
type of information or data. For example, an office may 
have a name and address file consisting of cards. Each 
card is used to record the name and address of a person. 
In this case, the card is the FORM on which data or 
information is recorded. 


FORMs contain “records” of information. The term 
“record” is most often used in this context by data 
processing or programming people. 


This term is used to describe what a FORM looks like 
before anything has been written in it. A name and address 
FORM may have the following FORM LAYOUT: 


SAAIAAAAAAAADAADAAAAAAAADAAAAAAAAAAAAAAA ARIA CR 


Name and Address FORM 


NS 


Address 
Phone 


PAAAAAAAAAAAIAADAAAAAADAAAAAADAAAAAAAASAAHASAAAAKR 


When using PERSONAL PEARL, your first step is to design 
the form layout. Then you can use it to record data or 
information. 


This is the name you give to a form you are creating. It is 
also used to refer to a program unit (a program unit can 
only have one form). This name is displayed on the Form 
Directory. 


PEARL DIRECTORY, PROGRAM DIRECTORY, REPORT DIRECTORY -- See 


DIRECTORY file. 


PRODUCTION 
DISKETTE 


This is a term used to describe the PROGRAM DIS- 
KETTE(S) when you are actually using the final product 
you have created. This diskette is generally placed on 
drive “B” of a two disk drive computer. 
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PROGRAM 


PROGRAM 
DISKETTE 


PROGRAM FILES 


PROGRAM UNIT 


A program consists of one or more PROGRAM UNITS. 
These program units may be independent or they may 
share (transfer) information. An example of a program that 
consists of program units that share information is the 
STARTER LIBRARY that is provided with the PERSONAL 
PEARL package. 


This term is used to describe the disk on which your 
PROGRAM FILES are found or created. These files include 
the DEFINITION, DIRECTORY, DATA, and INDEX FILES. 
The PROGRAM DISKETTE generally is placed on drive 
“B" of a two disk drive computer. | 


This is a term used for files containing the program 
definitions, instructions, report directories and FORMS 
(data) entered by you. For example, the ADDRESS pro- 
gram described in the tutorial consists of a FORM and a 
REPORT. The PROGRAM FILES will contain the FORM 
and REPORT LAYOUTS, and all other such definitions. 
Other program files are the DATA FILE and the INDEX 
FILE. 


A program unit consists of one form, and one or more 
reports. 


This term is used to describe an operation or function that 
the computer will perform. This term will be used exten- 
sively to describe functions that you have created using 
PERSONAL PEARL. For example, the tutorial section will 
guide you through the creation of an ADDRESS program 
unit. This ADDRESS program unit has the functions of 
storing the names, addresses, and phone numbers of 
people, and of producing a report based on the stored 
information. 


A program unit consists of one FORM and any number of 
REPORTS designed specifically to the form. Once a FORM 
is designed and installed, PERSONAL PEARL creates a 
host of support files on disk which include one data file and 
one index file for the program unit. (For detailed discussion 
on the number and types of files involved in a program unit, 
please refer to Appendix D). 


REPORT 


REPORT LAYOUT 


REPORT NAME 


SYSTEM 
DISKETTES(S) 
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An example of a program unit would be a “CLIENT” form 
and a “LABELS” report. The CLIENT form would be used 
to capture client information, and the LABEL report would 
be used to produce mailing labels from the information 
contained on the CLIENT form. 


In PERSONAL PEARL, this term is used in much the same 
way that it is always used. A report consists of an 
organized listing on paper of information or data from one 
or more sources or FILES. Each program or program unit 
you create may or may not have a report as one of its 
functions. In order to define a report, you must first define 
or create a FORM. 


This term is used to describe what the report will look like 
when it is printed. 


Each report is given a REPORT NAME. This name may be 
up to 7 characters in length and is the first step in defining 
a report. It is displayed on the Report Directory. 


This term is used to describe the disk(s) on which PER- 
SONAL PEARL files or PROGRAMS are found. 


Other terms used may be: PERSONAL PEARL 
DISKETTES, FILE MAINTENANCE DISKETTE, DESIGN . 
FORM DISKETTE, DESIGN REPORT DISKETTE, ENTER 
DATA DISKETTE, and PRODUCE REPORT DISKETTE. 
The SYSTEM DISKETTE(S) are generally placed on drive 
“A” of a two disk drive computer. 
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